home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 2: CDPD 1 / Almathera Ten on Ten - Disc 2: CDPD 1.iso / pd / 276-300 / 297 / jed / manual.txt < prev    next >
Text File  |  1995-03-14  |  65KB  |  1,701 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                    
  21.                                       
  22.                                  JED
  23.  
  24.                             The Jam Editor
  25.                              Version 1.1
  26.   
  27.                                (C) 1989
  28.                                  by
  29.                      
  30.                            Daniel R. Burris
  31.                           ALL RIGHTS RESERVED.
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.                       VERSION 1.1 ERRATA
  56.  
  57.               The Jam Editor Version 1.1 Enhancements
  58.  
  59. The Menu versus "select mark" Right Menu Button conflict has been resolved
  60. If you hold the Right Mouse Button long enough to have a pulldown menu 
  61. appear, you will not affect the current mark, or set a new one.
  62.  
  63. When asking for the current column and row, you get the actual line number 
  64. in the file, not the current screen line.
  65.  
  66. Bug was squashed that could leave an undeleteable "filename.Temp" on your 
  67. diskette, or hard drive.  Now if any filename renaming is unsuccessful, you 
  68. may delete the ".Temp" file normally.
  69.  
  70. When calling up JED V1.1 without a filename, you will get a buffer named 
  71. "a",instead of "Nameless.Jedfile".  This encourages short buffer names, and 
  72. suggests a simple way of using multiple buffers, I.E. the first one is "a",
  73. the second one is "b" ect.  Switching between buffers is then greatly 
  74. simplified.
  75.  
  76. The "Status Bar" has been fixed to truncate long Buffer names, and long File 
  77. names with an "$".  This way you will not have your screen change colors on
  78. you if you have a long buffer name with an even longer file name in it.  The 
  79. whole buffer name and file name are still remembered for saving purposes and
  80. changing purposes though, so don't worry.
  81.  
  82. The Keyboard overlay is a little more concise. No Big deal.
  83.  
  84. The Help file now includes a list of all the "Right Amiga" Menu to Keyboard
  85. equivalents.
  86.  
  87. Jed can now save all of your files with an Icon, if you so desire.
  88.  
  89. Jed can now create text in 3 different colors, to be viewed in batch files,
  90. or with a text viewer.
  91.  
  92. There is also a second, smaller version of Jed V1.1 that will uncrunch when
  93. it is loaded.
  94.  
  95. The macro functions are easier to use, with simpler Right Amiga key equiv-
  96. alents, while still retaining the old Emacs versions that Version 1.0 users
  97. have gotten used to.
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.                             PREFACE
  110.  
  111.  
  112. IN THE COURSE OF COMPUTER EVENTS, if a user encounters the need to create
  113. a batch file, or a startup file, or if a programmer encounters the need
  114. to create program source code, said user or programmer will also
  115. encounter the need for a *TOOL* to input that text or program source code
  116. with.
  117.  
  118. In short, people with computers need text editors.  And text editors can
  119. have very large lists of commands.  You must always muddle though the
  120. documentation looking for a command that does  what you need, or (ugh!)
  121. MEMORIZE the commands your regularly use.
  122.  
  123. Other text editors have very easy to remember (read very *SHORT*) command
  124. lists, but are too limited in scope for anything but small files.
  125.  
  126. Yet another class of editor is becoming available on the Amiga, the user
  127. configurable version.  These offer the very best of both worlds, giving
  128. you just the commands that you ask for in your personal version of the
  129. Editor.  But these tend to be too hard to set up and usually take up way
  130. too much memory.
  131.  
  132. From the above opinions (which are entirely my own), I set out to
  133. recreate an editor for the average user to use on their Amiga.  I say
  134. "recreate" because I started with the source code from two Public Domain
  135. sources, Memacs on Fred Fish Disk #22, and Pemacs on Amicus Disk #9. 
  136. These  two editors, gave me the source code to start on an editor that
  137. had the most commonly used and needed commands, (plus some very nice
  138. extras!).  I then added and removed pieces of code and debugged, and
  139. fixed, fixed up, then refined again, until the whole editor had been
  140. recreated as "JED".
  141.  
  142. I have tried to make the user interface to this editor as painless as
  143. possible.  My goal was to make it immediately usable without
  144. documentation.  The addition of an "onboard" text help file (press the
  145. help key), did a lot toward making this possible.  I also put what I
  146. thought to be the most useful commands on the pulldown menus, and on the
  147. Function keys (the "F" Keys).  There is even a keyboard overlay  at the
  148. end of the Help file that can be marked as a block of text and printed
  149. out.  Instructions on how to do this are in the help file also.  For
  150. later use, you can modify this file to suit your personal help needs,
  151. displaying only the commands that you have trouble remembering.  Or you
  152. can put some other instructions there for whatever you are using the
  153. editor for.
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.                                Features
  162.  
  163.   Here are just a few of the features that the Jam Editor is capable of:
  164.   (Here I go, blowing my own horn again!)
  165.  
  166.      User selectable Icon creation on all file saves.
  167.  
  168.      User selectable auto-indentation.  Choose whether or not the cursor     
  169.      should stop at column 1 (on a return), or line up with the last line.
  170.  
  171.      User selectable backup file creation. Keep (or not) the old copy of the
  172.      file that you are editing.
  173.  
  174.      Print an entire file, or just a block of text.
  175.  
  176.      Help at the touch of a help key, or pulldown menu.
  177.  
  178.      You may a "daughter" CLI from the editor, or run just one CLI Command. 
  179.  
  180.      You can enter the Jam Editor from CLI or Workbench.  Both ways can be
  181.      given a filename to edit upon entry.
  182.  
  183.      Has a small macro capability, to ease those repetitive typing tasks.
  184.  
  185.      Has very simple cut and paste.  Click on the start of the block to  
  186.      be cut with the right "menubutton", then click at the end of the block  
  187.      with the left "select button".  Then select Cut, then Paste from the Cut 
  188.      and Paste Pulldown menu.
  189.  
  190.      Can use multiple text buffers, even from within a split screen.
  191.  
  192.      Highlighted status bar, holding information on the current file and
  193.      buffer names, and whether the current file has been altered or not.
  194.  
  195.      User message passing is below the Status bar, in the tradition of most
  196.      Emacs Editors (In fact, many of the commands are Emacs compatible).
  197.  
  198.      Paging Down can be done by clicking on the word FILE: in the
  199.      Status bar.  Or anywhere below and right of it.
  200.  
  201.      Paging Up can be done by clicking the word BUFFER: in the Status bar.
  202.      Or anywhere below and left of it.
  203.  
  204.      The Screen can be pulled down to see previous compiler errors on     
  205.      the CLI Screen.
  206.     
  207.      The COLOR of the text yor create with Jed is USER SELECTABLE!
  208.  
  209.      There are too many more goodies to list here, so I will close with the
  210.      size of JED, the Jam Editor: 53997 bytes, Help File and all!  That's 
  211.      less than MicroEmacs alone! (The Small version is only 32701 bytes!)
  212.  
  213.      In Prospective you can replace Ed and Edit in you WorkBench disk/C
  214.      directory and only gain a total of 16,269 bytes of usage. Can you find
  215.      15K of unused baggage in your C: or Devs/Printers: directories? (Using 
  216.      the small version can actually SAVE you 5,027 bytes!)
  217.  
  218.               
  219.                             In Appreciation
  220.  
  221. A Special thanks to my Wife, for being patient while I hacked away at
  222. the code to the Jam Editor.
  223.  
  224. And thank you to my children, for doing without their daddy long enough
  225. to do this.
  226.  
  227. And thanks to Ed Tromble, for his unique usage of the slang term
  228. "Jammin'!" - which inspired the naming of this editor.
  229.  
  230. Also thanks to Andy Poggio and Rich Werth for their version of Memacs
  231. on Fred Fish Disk #22, and Andy Poggio for his version of Emacs on
  232. Amicus Disk #9.
  233.  
  234. And of course to Fred Fish, for all the great source code on his disks
  235. that I was able to draw upon. And for publishing Jed V1.0! (And Hopefully
  236. Jed V1.1!)
  237.  
  238.                         DISCLAIMER
  239.                 
  240. THERE IS NO IMPLIED WARRANTY OR RESPONSIBILITY ON THE AUTHOR'S PART, FOR
  241. ANY USE, MISUSE, ABUSE, OR LACK OF USE OF JED THE JAM EDITOR.  YOU USE IT
  242. SOLELY AT YOUR OWN RISK.  EVERY EFFORT HAS BEEN MADE BY THE AUTHOR TO
  243. MAKE THIS SOFTWARE AS STABLE AS POSSIBLE, BUT RESPONSIBILITY WILL STILL
  244. LIE WITH THE USER FOR ANY TROUBLE ENCOUNTERED WITH IT'S USE.
  245.  
  246.  
  247.              There's a new Smaller Version of Jed!
  248.  
  249. I have released two versions of Jed V1.1 distributed together.  The Larger of
  250. the two is the normal version, and weighs in at 45,268 bytes, without the
  251. file called "Jed.Help".  It is the "uncompressed" version of Jed V1.1, but 
  252. takes up "alot" of disk space, and of course, "gronks" longer to load off of
  253. a floppy diskette.
  254.  
  255. The smaller version of Jed V1.1 is the "compressed" version, and is only 
  256. 23972 bytes, without "Jed.Help".  I used a friend's compression program to 
  257. create this version, and it has all the same features as the larger version,
  258. and has been tested quite a bit, and works exactly the same!
  259.  
  260. Why would you want to use the larger version then, you ask?  Well, the smaller
  261. version, when loading, will "uncompress" itself to over 70,000 BYTES, then 
  262. drop down to the same size as the larger version when it is in memory.  This
  263. may cause a problem with 256k Amiga 1000 users, or with 512k users who are 
  264. editing very large files, or anyone who has a lot of stuff in memory already.
  265. The difference in a nutshell is that you must plan for about 25k more memory
  266. when loading smaller version.  If you load the smaller version, then load your
  267. file into it, there is no difference at all.  But if you try "Jed filename"
  268. you must think the 25,000 bytes of memory that it takes to expand the small
  269. version.  But if you have enough memory, and 25k is no problem, you should
  270. have no problem using the small version, and use less disk space, and less
  271. gronking!
  272.  
  273. You should use the "Large" version where memory is too tight to fit Jed, the
  274. file, and 25k "uncompressing space".
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.                      TABLE OF CONTENTS
  318.  
  319. Preface.................................................................1
  320. Features................................................................2
  321. In Appreciation.........................................................3
  322. Disclaimer..............................................................3
  323. About the Small Version of Jed..........................................3
  324.  
  325. CHAPTER 1 - Preliminaries...............................................7
  326.   JED Mouse Usage.......................................................7
  327.   Mouse Cut and Paste...................................................7
  328.   Looking Behind the JED Screen.........................................8
  329.   Loading JED from the CLI..............................................8
  330.   Loading JED from Workbench............................................8
  331.   Changed File Notification.............................................9
  332.  
  333. Chapter 2 - The Project Menu...........................................10
  334.   Going to Other Buffers...............................................10
  335.   Kill a Buffer........................................................11
  336.   Rename a Buffer......................................................11
  337.   Saving a File........................................................11
  338.   Loading a File.......................................................12
  339.   Save File As.........................................................12
  340.   Making a Hard Copy of a File.........................................12
  341.   Printing a Block of Text.............................................12
  342.   Quit & Save..........................................................12
  343.   Quit.................................................................13
  344.   Whodunit?............................................................13
  345.  
  346. Chapter 3 - The Cut & Paste Menu.......................................14
  347.   Cutting Text.........................................................14
  348.   Pasteing Text........................................................14
  349.   Copying Text to the KillBuffer.......................................14
  350.   Saving the KillBuffer................................................14
  351.  
  352. Chapter 4 - The Command Menu...........................................16
  353.   Searching Forward....................................................16
  354.   Search and Replace - with Query......................................16
  355.   Starting a Macro Definition..........................................17
  356.   Ending a Macro Definition............................................17
  357.   Using a Macro........................................................17
  358.   Entering a New CLI in JED............................................17
  359.   Running One CLI command in JED.......................................18
  360.   
  361. Chapter 5 - The Options Menu...........................................19
  362.   Getting Help in JED..................................................19
  363.   Splitting the Window into Two Windows................................19
  364.   Going back to One Window.............................................20
  365.   Turning Auto-Indent On and Off.......................................20
  366.   Turning Word Wrap On and Off.........................................20
  367.   Creating Icons for Your Text.........................................21
  368.  
  369.                  TABLE OF CONTENTS (CONTINUED)
  370.  
  371.   Setting the Left Margin..............................................21
  372.   Setting the Right Margin.............................................22
  373.   Turning the Backup Option On and Off.................................22
  374.   Text Color Selection.................................................22
  375.  
  376. Chapter 6 - The Get Around Menu........................................24
  377.   Going to the Beginning of Your File..................................24
  378.   Going to the End of the File.........................................24
  379.   Going to a Specific Line.............................................24
  380.   Going Down One Page..................................................24
  381.   Going Up One Page....................................................24
  382.  
  383. Menu Conclusion........................................................25
  384.  
  385. Chapter 7 - The Function Keys..........................................26
  386.  
  387. Chapter 8 - The Keyboard Commands......................................27
  388.  
  389. Registering your Copy of The Jam Editor................................30
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.                        CHAPTER ONE
  422.  
  423.                        Preliminaries
  424.  
  425. First I should cover some things about the use of the mouse, then I will
  426. go on to the Pull down menus, in order, then the Function keys, then the
  427. keyboard activated commands.
  428.  
  429.                    JED Mouse Usage (On Version 1.1)
  430.  
  431. The mouse can make the using The Jam Editor (JED) much faster and simpler to
  432. use than just keyboard commands.  But it is still be up to you to decide
  433. how often to remove your hands from the keyboard to access the mouse's power.
  434.  
  435. First of all, the Right Mouse button has been fixed with Jed V1.1.  It will
  436. take a single "Click" to set the Mark, as before.  But, if you pull down the
  437. menus, and don't select anything, you may now just let go of the mouse button,
  438. and Jed will determine that the menus have been pulled down, and not set
  439. the mark!
  440.  
  441. For instance, let's suppose you wish to use an item on a pulldown menu,
  442. and then change your mind.  You might pull the mouse pointer down into
  443. the text, below the last item on the menu, and then just release the mouse
  444. button.  Beginning with Version 1.1, Jed will do nothing! If you had a
  445. mark set prior to pulling down the menu, it will still be set in the same
  446. place.  This means you don't have to pull the mouse up to the Title Bar before
  447. releasing the right mousebutton!  Now the only inconvience in using the mouse
  448. to cut and paste, is that you have to move your hand from the keyboard to the
  449. mouse!  This little inconvenience is well worth it when you begin to do a lot
  450. of cuts and pastes.
  451.  
  452.  
  453.                         MOUSE CUT AND PASTE
  454.  
  455.      To cut and paste with the mouse do the following:
  456.  
  457.      1. Find the beginning of the text to be cut.  Remember that clicking 
  458.     the Left Mouse on the word "FILE:" in the Status Bar will page down
  459.     thru the text, and clicking on "BUFFER:" will page up.
  460.    
  461.      2. Click the RIGHT Mouse button at the beginning of the block of text
  462.     to be cut.This will move the cursor to the point where the mouse
  463.     pointer is and Mark a new start of Block.
  464.  
  465.      3. Click the LEFT Mouse button  at the end of the block of text to be   
  466.     cut.  This will move the cursor to that point. (Again, you may page
  467.     up or down to get to this spot.) 
  468.     
  469.      4. Then select "Cut" from the "Cut and Paste" menu.  The block of text  
  470.        that you had selected has been cut out of your text and placed in the 
  471.     killbuffer.
  472.  
  473.      5. You may now paste it any place that you like.  By a click of the Left 
  474.         Mouse, place the cursor where you would like to put the block of     
  475.         text, and select "Paste" from the "Cut and Paste" menu.  Your text is 
  476.         back in the new location.  You could have easily changed to another  
  477.         file in another buffer, and pasted it there, or printed it to the    
  478.         printer, or saved it as a file.  These options will be explained     
  479.         further during the Pull Down Menu descriptions and various places.
  480.  
  481.  
  482.                   Looking Behind the Screen
  483.  
  484. You can look "behind" JED, by simply pressing and holding the Left Select
  485. Button in the Title Bar, then dragging the whole Screen downward with the
  486. mouse.  You can of course drag it back up again!  This is a very handy
  487. feature if you want to see what line compiler errors were reported on in
  488. the CLI window, or if you want to access WorkBench.
  489.  
  490. Loading JED from CLI
  491.  
  492. You may enter JED from the Command Line Interface (CLI) in the
  493. traditional Emacs format:
  494.  
  495.     1> JED [Filename] [Return]
  496.    or:
  497.      1> JED [Return]
  498.  
  499. The first example will bring up JED and the help file, with the File
  500. specified in [Filename] in the current buffer.  If the path/filename that
  501. you requested could be found, the buffer will be empty, and will show the
  502. Filename that you requested.  But if you type in some text and Save the
  503. File, (the F1 - Function Key, or from the Project Menu or [Control+X] +
  504. [Control+S]) it will be saved to the path/filename you requested.  This
  505. is a very good way to create new text files.
  506.  
  507. The second example will also load JED and the help file, but will present
  508. you with an empty buffer named "a".  You may then load a
  509. file (F2 or from the Project Menu, or [Control + X] + [Control + V]),
  510. which will prompt you (below the Status Bar again - called the message
  511. area) for a filename, load it in, and rename the buffer.  It will then
  512. remember where to save it.  * Note * - If at any time, JED forgets where
  513. to save your file, Select "Save as" from the Project Menu, and enter a
  514. path/filename in the message area.
  515.  
  516.                 Loading JED from WorkBench
  517.  
  518. When Loading JED from Workbench, you can just double click on the JED
  519. Icon.  This will be the same as the second example in Loading JED from
  520. CLI above.  You can Also load JED from Workbench with a filename!  The
  521. file must have a project Icon by same name as the text file, (IE. Word
  522. Perfect files, or Fred Fish Disk "doc" files-that look like books).  You
  523. can then click once on the Project Icon for the text file to edit, hold
  524. down the shift key, and then double click on the JED Icon.  JED and the
  525. help file will then be loaded, and the file you selected with Project
  526. Icon will come up as the current Buffer!  With Jed Version 1.1, if you 
  527. save a file with an Icon (from the Options menu - select Icon Creation)
  528. you can double click on that project icon (Jed's) and Jed and the Help
  529. file will be loaded, and so will the text file! (See Icon Creation for 
  530. more info).
  531.  
  532. Changed File Notification
  533.  
  534. When you first change a file in Jed, the screen will flash.  You didn't do 
  535. anything wrong!  Just look down at the Status bar, and you will see that is 
  536. has changed from "[ORG]" to "[CHG]".  All this is just to alert you that you
  537. have changed the current file and that you should save it before quiting Jed.
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.                          CHAPTER TWO
  578.  
  579.                       The Project Menu
  580.  
  581.  
  582. The Project Menu is a standard Amiga Pulldown menu.  It is The
  583. Leftmost Menu on the screen, and has the most important functions for
  584. file and "Buffer"  handling (A buffer is a window in JED that contains a
  585. File to be edited, or the Help File). The Title of each section will be
  586. exactly as it appears in the Project Menu.  What follows is a breakdown
  587. of each of the Project Menu commands, and some uses and tricks with each.
  588.  
  589.                "Other Buffer  SFT/F7"
  590.  
  591. Above is what you will find if you use the right menubutton and go to the
  592. rightmost menu in JED.  It will be the top item that you can select. 
  593.  
  594. I have found that switching buffers (going back and forth between files)
  595. is quite a regular occurance when cutting and pasting source code from
  596. one file to another.  So I have decided to put it first on this menu.
  597. Strictly for quick access.
  598.  
  599. In case you are wondering, the SFT/F7 in the selection name is just the
  600. key equivalent to using the menu.  They are included in all the menu
  601. choices in JED.  You could also use the standard Emacs command, Cx/b. 
  602. This means to hold down the key marked CTRL on the keyboard, then strike
  603. the x character, then lift off of keys and hit the b key.  More on
  604. keyboard commands in Chapter 8.
  605.  
  606. When you select "Other buffers", you will be asked for a new buffer name
  607. in the message area.  The buffer name in between the [] symbols is the
  608. previous buffer that JED was in.  If you have just loaded your file, and
  609. ask for Other Buffer, this should be Jed.Help - the help file. The reason
  610. for this is that JED loaded it first, then switched to a new buffer, and
  611. then loaded your file.  If you just hit return, you will be face to face
  612. with the Help file (The same as if you hit the HELP key).  If you select
  613. Other Buffer at this point, you will be prompted again, only the buffer
  614. name in between the []'s will be your file name. You see, JED remembers
  615. what the last buffer you were in was.  If you hit return, you will be
  616. back in your file, in the same place you left it. This "last file
  617. remembrance" is very nice when switching between two files a lot.  Just
  618. select Other Buffer, hit return, and you have switched to the other
  619. buffer in the same point you were last in it.
  620.  
  621. What if I don't want to go to the last buffer that JED was in, you ask? 
  622. Just type in buffer name that you want at the prompt in the message area. 
  623. Caution:  The buffer names are case sensitive.  If you type a buffer name
  624. of "code.c", when you really wanted "Code.c", you will create a buffer
  625. named "code.c", and switch to it.  If this happens, just select Other
  626. Buffer again, and type the correct Buffer name.  As you can see, it is
  627. easy to create a new buffer with Other Buffers, to load a new file into. 
  628. But what about the unwanted Buffer named "code.c" that we just created? 
  629. This brings us to the second item on the Project Menu...
  630.  
  631.                   "Kill Buffer  SFT/F8"
  632.  
  633. If you select this menu Item, you will be prompted with "Kill Which
  634. Buffer: " in the message area.  You simply type the name of the buffer to
  635. kill and hit return.  The buffer will then be emptied out, and deleted from
  636. the list of buffers that JED is using. Even the Memory that was given to
  637. this buffer is freed up. Gone. Bit the Bullet. To the Bit Bucket. 
  638. Obviously, this command should be used with care.  If you call this
  639. command by accident, just click the left select button in the window
  640. above the status line, and the screen will flash (meaning you gave an
  641. invalid command), and return you safely to editing the buffer you are in.
  642. * Note - It is a good habit to get into, when deleting buffers, to first
  643. hit the Shift/F6 key, to examine the active buffers that JED currently
  644. has, then select Kill Buffer, type in the buffer name exactly as listed,
  645. and hit return.  You will get a status back from JED telling you that the
  646. unwanted buffer has been deleted.  Then just hit Shift/F4 and you will be
  647. back to one window, with your current file ready for more editing.  More
  648. on these Function keys and their usage in Chapter 7.
  649.  
  650.                 "Rename Buffer  Cx/Cf"
  651.  
  652. This command (3rd in the Project Menu), will just prompt you for a new
  653. buffer name (for the current buffer).  You just type one in, and hit
  654. return. By the way, you are allowed to backspace if you make a typo in
  655. the message area.  This command is here mainly to change the buffer name
  656. to the same name as the file that it now contains, or to a shorter buffer
  657. name.  For instance, if you use other buffer to go to a brand new buffer
  658. named "b", and then load your file named "Code.c", you may want to rename
  659. you the buffer "b" to "Code.c" to match your filename.  Or if you have a
  660. buffer (for whatever strange reason) named "adsflkajdfpoewtrpoas",  you
  661. may want to rename it to something shorter and easier to remember.
  662.  
  663.                     "Save    F1"
  664.  
  665. This 4th command in the Project Menu, is just what it implies.  It saves
  666. the file in the current buffer,  to the current buffer's filename.  All
  667. pathname information should, under normal circumstances be automatic.  If
  668. you get a message back stating that JED couldn't remember where to put
  669. the file, use "Save File As  Cx/Cw" (explained later in this chapter),
  670. and type in the correct path/filename to save it to. But this shouldn't
  671. usually happen.  Since this menu choice is also tied to the F1 key, you
  672. can update your file on disk regularly by simply hitting F1, and waiting
  673. for your disk to quit "gronking".
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.                     "Load    F2"
  682.  
  683. This (still on the Project Menu) is simply for loading a file into the
  684. current buffer, but there a few things to be aware of.  If your current
  685. buffer has your only copy of your Pulitzer Prize winning novel in it, you
  686. might want to save it first, or use "Other Buffer" first, and create a
  687. new buffer to load the new file into.  If you do try to load a different
  688. file into a buffer that has been changed (from the original on disk), JED
  689. will ask you if that is what you really want to do, and wait for a Y or N
  690. for a yes or no, and of course, the ever popular [RETURN].
  691.  
  692.                 "Save File As  Cx/Cw"
  693.  
  694. When this item is selected from the Project Menu, you will be prompted
  695. for a "Path/Filename:" in the message area.  You should be careful to
  696. type the full path to the place that you actually want to put the file in
  697. current buffer. JED is just a slave.  He will follow your "Save As"
  698. command to the letter...
  699.  
  700. The "Cx/Cw" part of the Menu Item name stands for the keyboard sequence
  701. of:   Hold down the CTRL key, then hit the x key, lift off both keys,
  702. then hold down the CTRL key again, and hit the w key. This isn't as bad
  703. as it sounds, and to all you Emacs junkies out there, it is compatible.
  704.             
  705.              "File Hard Copy [RIGHT AMIGA] H"
  706.  
  707. This seventh Project Menu choice will print the file in current buffer.
  708. It doesn't have any Emacs compatible key commands, as I added it.  If you
  709. start to print a file that you didn't want to, you can just shut off the
  710. printer (primitive I know..) and wait for a "Printer trouble" requester,
  711. then select Cancel.  At least you can get out of it!
  712.  
  713.                "Print Block  [RIGHT AMIGA] P"
  714.  
  715. Command Number 8 on the Project Menu can be used to print the currently
  716. marked block in current buffer.  If you use the "Mouse Cut and Paste"
  717. instructions on page 6, and when you get to step number 4, instead of
  718. selecting "Cut" from the "Cut and Paste" menu, you select this command,
  719. the block that you have selected will be printed to your printer.  This
  720. can be very handy for closely scrutinizing a buggy function in your
  721. source code, without the loss of time and paper it takes to print a whole
  722. file.
  723.  
  724.                     "Quit & Save  F10"
  725.  
  726. This command will automatically save your text to the file that it came
  727. from, or if you loaded a non-existent file with a correct path/filename
  728. (IE: JED df0:c/test), it will save the newly created file to it's new
  729. path/filename.  Then the JED will self exit.  This is the recommended way
  730. to exit.  If the file in the current buffer is current on the disk, as
  731. after a save command and no changes (the Status Bar shows [ORG]) JED will
  732. just self exit.  This saves time and chances of disk errors from
  733. redundant saves.  If you prefer to save and exit manually to have more
  734. control (not really any safer), use the save command above and the next
  735. command.  This command can also be invoked with the CTRL key plus the z
  736. key.
  737.  
  738.                     "Quit    SHT/F10"
  739.  
  740. This Project menu item just exits the program.  If any buffer you have
  741. active in JED has [CHG] in the Status Bar, and you select Quit, you will
  742. be prompted with "Modified buffers exist exit Y/N?".  At this point you
  743. can select N and go through and save all changed files, and quit again. 
  744. You can find out about which buffers are changed with Shift/F6.  This
  745. command will display JED's active buffer list, or the buffers that you
  746. have asked JED to make if you will.  It will also contain information as
  747. to which buffers are changed. Then hit Shift/f4 and you will be back to
  748. one window.  Use "Other Buffer" to go to the changed buffers, then do a
  749. Save (F1) as described above, and then exit.  Now you will find, if you
  750. have saved everything, and all buffers are current, JED will exit without
  751. a complaint.
  752.  
  753.               "WhoDunit?  [RIGHT AMIGA] W"
  754.  
  755. This the last item (and least used) of the Project Menu is a plug for the
  756. Jam Editor V1.1, and a few bucks for my efforts.  If you feel guilty enough
  757. to send something, but don't feel it is worth all of seven dollars, send
  758. what you think it is worth.  I probably will still register you anyway,
  759. if your offer is within reason.  Thanks for your support.
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.                       CHAPTER THREE
  786.  
  787.                    The Cut & Paste Menu
  788.  
  789. This pulldown menu, which is just to the right of the Project menu, is
  790. strictly for use with Blocks of text.
  791.  
  792.                       "Cut    F8"
  793.  
  794. The first choice on the Cut & Paste menu is Cut.  I put it first for
  795. quickest access in using only the mouse to cut a block of text (See step 
  796.  #4 of "MOUSE CUT AND PASTE" on page 7).  It simply cuts a block of text
  797. (that you have marked) out of the current buffer and puts it in the
  798. "Killbuffer".  The Killbuffer is a non-visible buffer that saves any text
  799. that you remove until you restore it or cut out more text. IF YOU CUT OUT
  800. MORE TEXT, THE LAST TEXT THAT YOU HAD IN THE KILLBUFFER WILL BE LOST.
  801.  
  802. Generally, you will want to use the mouse for this function.  But if you
  803. don't like to lift your hands off the keyboard, you can use the F8 key as
  804. shown in the name of the Menu Item.  Or you can use the old Emacs standby,
  805. the CTRL key, and the W key. 
  806.  
  807.                     "Paste  F9/F9"
  808.  
  809. This second choice on the Cut & Paste menu is for restoring the killbuffer
  810. to your text at the place where the cursor is.  This can be in a
  811. different place in the file, several places in the file (you can paste
  812. the same text as many times as you like), or a different file completely.
  813. The Keyboard way of invoking Paste is F9 + F9, or the Emacs equivilent of
  814. CTRL + Y (for Yank).
  815.  
  816.             "Copy to KillBuffer  [RIGHT AMIGA] C"
  817.  
  818. This command is the same as a Cut operation (above), except that it does
  819. not remove the chosen block of text from you file.  It just COPIES the block
  820. of text to the killbuffer.  This is the one that I use when copying text
  821. from one file to another.  I use it because my original, debugged file
  822. remains unchanged when moving a *COPY* of the text to the new file.  I
  823. only use Cut for rearranging text in a file.  You can access this command
  824. from the keyboard by holding down the Right Amiga key, and then pressing
  825. the c key.
  826.  
  827.             "Save KillBuffer  [RIGHT AMIGA] S"
  828.  
  829. This command will save the killbuffer to a file.  JED will prompt you for 
  830. a Path/Filename to save the Killbuffer to, then save it there.  This
  831. command is handy for cutting out things ahead of time, and saving them
  832. until your friend gets back with the disk you are working on.  Note: You
  833. should use the Project Menu's Print Block function to print blocks of
  834. text, but if you find you already have something in the Killbuffer (say
  835. from a Cut command) and want to print it, you can "Save KillBuffer" to
  836. PRT: if you like, and it should work just fine.
  837. If you have the Icon Creation feature of Jed V1.1 turned on before using this 
  838. option, your Killbuffer will be saved with a Project Icon.  This is very handy
  839. for making small batch files that run from an Icon, from a larger Icon.
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.                          CHAPTER FOUR
  890.  
  891.                            The Command Menu
  892.  
  893.                     "Search Forw.  SFT/F1"
  894.  
  895. The first item on the Command Pulldown Menu is for searching forward. 
  896. The search begins at the cursor, and searches toward the end of the text,
  897. for a text string that you give to JED in the message passing area.  You
  898. select this item from the Pulldown menu, or holding down the Shift Key,
  899. then pressing the F1 function key, or using the Emacs command CTRL S. 
  900. This is done by pressing down the CTRL key, then pressing the s key. 
  901. Whichever of the 3 ways that you call up Search Forward, you will be
  902. prompted in the message passing area with "Search for What String? ".
  903. You then type in the wanted string, or enough of that string to help JED 
  904. find it for you.  If JED finds your string, the search is stopped.  The
  905. cursor will be at the end of asked for string.  The string that you asked
  906. for will be remembered, so if you really wanted the second occurance of
  907. the string (from where you started your search), you can just call Search
  908. Foward again.  The message area will again display "Search for What
  909. String?", but with the string that you typed in the last time that you
  910. used "Search Forward" in the prompt in the () characters.  If this is the
  911. string that you want, just press return, and JED will search again toward
  912. the end of the text for that string from the cursor.  This string is
  913. remembered even if you load a new file, and forever until you type in a
  914. new search string, or quit JED.  This is handy if you have to search over
  915. several text files for a particular piece of source code, or paragraph of
  916. text that must be changed.
  917.  
  918.                    "Query/Repl.  SFT/F3"
  919.  
  920. This 2nd command of the Command menu is very simular to the Search
  921. command above it.  It starts at the cursor, and looks toward the end of
  922. the text, for an occurance of your string.  And it also remembers the
  923. last string searched for (in fact it remembers it in the same place as
  924. the Search command above so you can switch commands with the typed string
  925. intact).  But that is where the simularity ends.  When you call Query and
  926. Replace from the Command menu, or by holding down the Shift key and
  927. hitting F3, or by hitting the Alt key, then holding down shift key, then
  928. hitting the shifted 5 key (This is called ALT + %), you will be prompted
  929. for an "Unwanted String", and then a string to replace the unwanted
  930. string with ("New String").  JED will then search from the cursor to the
  931. end of the text for an occurance of your requested string.  If JED finds
  932. an occurance, you will be given the options to:
  933.  
  934.      1. Replace this newly found string with your 2nd given string.
  935.      2. Replace ALL strings matching your 2nd given string.
  936.      3. Skip this occurance of the searched for string.
  937.      4. Hit CTRL + G and escape the Query/Replace function and go back
  938.         to editing text.
  939.  
  940.  
  941.                  "Start Macro  [RIGHT AMIGA] + M"
  942.  
  943. The next 3 commands on the Command Pulldown menu go together.  They let
  944. you create simple macros, and execute them.  This first one, Start Macro,
  945. of course lets you start the macro.  It is invoked from the Pulldown
  946. easiest, but can also be invoked by holding down the CTRL key, hitting
  947. the x key, releasing both keys, then holding down the SHIFT key, and
  948. hitting the ( key (the shifted 9 key).  You then type your simple macro
  949. (try to avoid RETURNS and CURSOR DOWNS), and Then select the next option,
  950. which is "End Macro [RIGHT AMIGA] + E".  This will complete the macro
  951. definition. You can then invoke the newly defined macro by invoking the next
  952. command after the "End Macro [RIGHT AMIGA] + E", which is Use "Macro ALT/E".
  953. The key exact sequence that you typed in between Start macro and End Macro
  954. will then be inserted into the text at the cursor.  BEWARE!  When you use 
  955. Cursor Down keys, you will only record the first one. For more than one, use
  956. [RETURN].  And if you use a second macro definition, you should use the Emacs
  957. key sequence, "CTRL + x + (" to start the macro, as it clears the old macro
  958. out of Macro storage buffer.  The pulldown menuitem and the Right Amiga
  959. keyboardequivilent WILL NOT CLEAR THIS BUFFER.  You will have your new macro,
  960. and, if it was shorter than the old macro, and the last few characters of the
  961. old macro! 
  962.  
  963.                 "End Macro  [RIGHT AMIGA] + E"
  964.  
  965. See Start Macro for usage of this Command menu item.  It is called from
  966. the menu easiest, or you can Hold down the CTRL Key, then hit the x key,
  967. release, then hold down the SHIFT key, and hit the ) (the SHIFTed 0 key).
  968. I personally feel the the pulldown is easier. Or you can use the Right Amiga
  969. key  and the "m" key.
  970.  
  971.                     "Use Macro  ALT/E"
  972.  
  973. See Start Macro for usage of this Command menu item.  It is called from
  974. the Pulldown, of course, or, you can hold down the ALT key, and press the
  975. "e" key.  I usually only use macros when I have many identical changes to
  976. make to several lines.  I don't use them often, so I use the pulldown the
  977. first time (to see the key sequence), and then use "ALT/E" for all
  978. subsequent times.
  979.  
  980.                         "New CLI  Cc"
  981.  
  982. This Command Menu choice will open up a large Command Line Interface
  983. (CLI) from within JED.  You can then proceed to compile files, copy
  984. files, read text files, and run most programs.  I have actually forgotten
  985. that I was in JED from time to time!  The instructions for exiting JEDCLI
  986. can be found at all times in the JEDCLI window Title Bar. (This also
  987. reminds some of us that they started this CLI from the Editor...).  You
  988. can enter a New CLI from the Pulldown, or By holding down the CTRL key
  989. and tapping the c key until the window appears. Generally,though,  I use
  990. the CLI command option described below.
  991.  
  992.  
  993.  
  994.                     "CLI Command ALT/Q"
  995.  
  996. This is simular to the "New CLI Cc" command above, but can be used to
  997. quickly run one command (or program, or batch file) from and have the CLI
  998. window automatically exit about 1 second after the command is done. This
  999. is very handy for compiling a program from a batch file containing the
  1000. compiling and linking instructions (immediately after a Save - F1, of the
  1001. current source code in that you just fixed in JED).  Or for displaying a
  1002. directory.  Or my favorite, running one of the many Directory Utilities
  1003. found on the fish disks.  If you list a directory this way, You may want
  1004. to quickly get to the mouse, and hold down the RIGHT menu button, to stop
  1005. the action, as after about one second, the window will close back up and
  1006. you will be back in the editor as if you never left it (of course you didn't,
  1007. as you can see around the edges of the CLI window!)  You can use this command
  1008. from the pulldown as always or by holding the ALT Key, and pressing the "q"
  1009. key.
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.                          CHAPTER FIVE
  1046.  
  1047.                           THE Options Menu
  1048.  
  1049.                     "Help On/Off  HELP"
  1050.  
  1051. This first item on the Options menu (1st for ease of access), is to get
  1052. the Help menu displayed.  You can more easily display it, as the key
  1053. sequence given in the menu shows, by hitting the HELP key.  You will be
  1054. face to face with the first page of the Help file - Jed.Help.  If you
  1055. select this menu option again (or hit the HELP key), you will be back in
  1056. the file that you just left, in exactly where you were before you called
  1057. help (this has been standard in buffer switching in JED, so you don't get
  1058. lost in a file that you were previously in).  If you recall the Help
  1059. file, you will be back at the beginning of Jed.Help again, where the most
  1060. commonly need help can be found.  You can move around in the Help file
  1061. the same as any other text file.  You can edit it to suit your own needs
  1062. (although you should save a copy of it to another disk before doing
  1063. this).  If you want to arrive in the HELP file in a different place than
  1064. the start of the file, you can always enter and exit it with "Other
  1065. Buffer" from the Project menu, and your place will be remembered as
  1066. always.
  1067.  
  1068. While you are still new to JED and it's commands, you should enter the
  1069. Help file, page down (by using the F6 key) until "Page #8" is displayed
  1070. in the top right of the text area.  There you will see instructions on
  1071. printing out a simple (new!) keyboard overlay.  You can then paste it 
  1072. together and place it over the "F" keys on your keyboard.  This should be
  1073. a great help to good typists, that don't want to use the mouse all the time
  1074. to see the keyboard equivilents on the Pulldown menus.
  1075.  
  1076. Another feature of the HELP File, is that all of the Emacs Key Commands
  1077. that JED has are listed there.  Some of these are not on the Pulldown
  1078. menus, or on the Functions keys.  I have configured JED as I would have
  1079. configured a user configurable editor for my own use.  It's all there,
  1080. but in a MUCH smaller package.
  1081.  
  1082.                 "Split Window Cx/2"
  1083.  
  1084. This 2nd command of the Options menu will give you two editing windows,
  1085. with two status bars.  It is possible to load two different files into
  1086. the two windows, and cut and paste between them, compare them visually. 
  1087. BUT YOU MUST BE VERY CAREFUL AS TO WHICH  WINDOW THE CURSOR IS IN, as the
  1088. cursor will switch from time to time on paging up and down operations, on
  1089. End of file, top of file,or other logical (to the program) operations.  You
  1090. can change which is active by the standard Amiga concept of clicking on the
  1091. window that you want active.  I generally don't use this option, but
  1092. when I do, it can save the day.  I generally use the "Other Buffer" option
  1093. and switch between full screen buffers instead.  But I ocasionally use it to
  1094. compare 2 pieces of "C" code with unusually strange syntax, to see what {, :,
  1095. or * that I left out.  Visual comparisons sometimes can be the only awnser. 
  1096. You can also get to this option with holding down the CTRL key, then hitting
  1097. the x key, releasing both keys, then hitting the 2 key, as the command
  1098. suggests.  On the pulldowns, all "C"'s mean the CTRL Key, and all ALT mean
  1099. the Alt command.  All F's mean a function key, and are always followed by a
  1100. number of 1 thru 10.  All SFT's stand for SHIFT, and all square boxes with
  1101. the letter A in them (in inverse video) stand for RIGHT AMIGA.  This will be
  1102. come obvious in time, and some EMACS users will recoginize it immediately.
  1103.  
  1104.                    "One Window SFT/F4"
  1105.  
  1106. This 3rd command on the Options Menu is to restore the display to the
  1107. currently active window only.  It is used generally after the command
  1108. above it, "Split Window Cx/2".  Or it is also used to restore the display
  1109. to one window after displaying the list of active buffers JED has (See
  1110. Chapter7  - SHIFT/F6).  You can also select this option by holding down the
  1111. SHIFT key and hitting the F4 key as shown in the menu.  Also, you may use the
  1112. Emacs version, CTRL key, plus the x key, release,then hit the "1" key.
  1113.  
  1114.                     "Auto Indent Cx/i"
  1115.  
  1116. This command is one that I find particularly useful, and is a Default in
  1117. JED.  You can tell if it is active by checking the menu itself, as you
  1118. will see a Checkmark by it if it is active, and a blank space if it is
  1119. not.  If it is active, upon the user typing a RETURN, or if word wrap
  1120. takes place (see the next Options menu option), the cursor, will
  1121. automatically advance to the column of the first character of the above
  1122. line with text on it.  This is extremely useful when you indent your
  1123. source code (for readibility) as your nesting gets "deeper". or if you want
  1124. a paragraph in a letter to be indented by a few spaces, just turn on Auto
  1125. Indent, and Word Wrap, and space the first line of the paragraph the
  1126. required amount, and type away worry free (well, almost, no spell checker
  1127. is included).  You can also access this by holding down the CTRL key,
  1128. then hitting the x key, and then releasing both keys, and then hit the "i"
  1129. key.
  1130.  
  1131.                     "Word Wrap  Cx/t"
  1132.  
  1133. This is word wrap in the traditional sense, but with one difference.  If
  1134. you append text on a line and it goes beyond the current setting of your
  1135. right margin (explained later in this chapter),it will run to the end of
  1136. the text area and display an "$" at the edge of the screen.  You can
  1137. correct this if you want to by putting the cursor on place that you want
  1138. to break the text, and hitting a return.  You will sometimes get a
  1139. stationary character in the first column of the next line, and you can
  1140. get rid of it typing CTRL and "l".  This will redisplay the screen, and the
  1141. unwanted stationary key will disappear.
  1142.  You can turn this menu option on and off (this also has a check mark to let
  1143.  you know if it is on or off), by the main menu, or holding down the CTRL Key,
  1144. hitting the x key, and releasing both, and hitting the "t" key.  The JED
  1145. default for this option is On.  I like to keep my text on screen in front of
  1146.  me!
  1147.  
  1148.  
  1149.              "Icon Creation [RIGHT AMIGA/I]"
  1150.  
  1151. This is a new Options Menu Item with Jed V1.1.  When you select this item, 
  1152. all files saved will have a Project Icon saved with them, just as they would
  1153. have from NotePad (NotePad comes with Workbench)!
  1154.  
  1155. THE PROJECT ICONS CAN ONLY BE CREATED WITH JED IF YOU HAVE THE FILE CALLED
  1156. "icon.library" IN YOUR CURRENT "SYS:LIBS" DIRECTORY. (Note that this is the
  1157. DEFAULT with a Workbench disk, or any disk that boots up to a Workbench
  1158. screen, and has Icons on it).
  1159.  
  1160. Your newly created file can then be brought into Jed (IF JED IS IN THE SAME
  1161. DIRECTORY) by double clicking on the new icon.  If not, click one time on the
  1162. new icon, to highlight it, then pull down the Workbench Menu from the
  1163. WorkBench screen and select "info".  You will then be in your new Project
  1164. Icon's Info Screen.
  1165.  
  1166. Just click once in the "Default Tool" string gadget, and type in the path to
  1167. you keep Jed.  If you use Jed in your SYS: Directory,you could just type
  1168. "SYS:Jed" and hit return.  Then click on the save button.  Your Project Icon
  1169. now knows that your copy of Jed is in the SYS: directory, and double
  1170. clicking on it will now load your "Sys:Jed" program, and then load the text 
  1171. file attached to the Project Icon into Jed for editing.
  1172.  
  1173. Also you might try changing the Project Icon's default tool to "SYS:Utilities/
  1174. more" to view a file that you created, (if you have Workbench V1.3 "more" will
  1175. be found on the Workbench disk, in the Utilities directory). If you don't have
  1176. Version 1.3 of workbench, you can find many versions of "more", or "less" on
  1177. the Fred Fish Disk Collection. (try the one on Fred Fish Disk #180, in the Jed 
  1178. directory for instance!)
  1179.  
  1180. You can EXECUTE a batch file that you typed in Jed and saved with an Icon, by
  1181. changing it's "Default tool" to "SYS:C/Iconx"(if you have Workbench Version
  1182. 1.3).  If you don't have Workbench V1.3 and can't free up $29.95 for it right
  1183. now, you can find a great substitute for the Iconx program on Fred Fish Disk
  1184. #102.  Thanks again to Mr. Fred Fish for his invaluable contributions to the
  1185. Amiga.
  1186.  
  1187. Using combinations of the above Default Tool suggestions with a hard drive,
  1188. can allow you to work on source code, compile, & link, all from workbench!
  1189. You may also toggle Icon creation on and off by using the keyboard.  Simply
  1190. hold the "Right Amiga" key down, and then press "i" (for Icon).
  1191.  
  1192.                 "Left Margin  RIGHT AMIGA/L"
  1193.  
  1194. This sets the margin of blank space on the left side of your screen, that
  1195. is skipped when the text wraps around while typing.  When it is selected,
  1196. you will be prompted with Left Margin: 4 .  If you just hit return, you
  1197. will get the default.  Or you can type in your own preference, and it
  1198. will be changed on the next word wrap. You don't have to delete the "4"
  1199. after "Left Margin:", you just type over it. 
  1200.  
  1201. You can also set this by holding down the Right Amiga key, and pressing the
  1202. "l" key. 
  1203.  
  1204.                 "Right Margin RIGHT AMIGA/R"
  1205.  
  1206. This sets the margin of blank space on the right side of your screen, that
  1207. will be skipped when word wrap takes place to a new line.  You can select it
  1208. by the menu of course, or by holding down the Right Amiga key and pressing
  1209. the "r" key. You will be Prompted with "Right Margin:75" and as above with
  1210. the Left Margin, you don't have to delete the 75, you just type right over it.
  1211.  
  1212.                  "Make Backups RIGHT AMIGA B"
  1213.  
  1214. This option on the Option Menu is for setting whether or not a backup file
  1215. is created or not.  There is a checkmark to tell you if the backup option is
  1216. on, and none if it is off.  The JED default is OFF.  If you turn it on, you
  1217. will be told that a backup file will be made in the message area, and a 
  1218. checkmark will appear in the menu to the left of the menu name.  When this
  1219. option is on, upon saving the new file, the original file will be renamed
  1220. to your filename, plus the extention of ".backup".  Then your new copy of the 
  1221. file will be saved.  This way, if you want to try some new large change to 
  1222. some text file, and don't know if the changes will work (as in the case of 
  1223. source code), you set the Backup Option to on, and make your changes and save 
  1224. as usual.  If the change didn't work, you can delete your new file, and rename
  1225. the one with the ".backup" extention to the same name - without the ".backup",
  1226. and you will be back to where you started.  This is a nice feature if you are
  1227. unsure of your changes, but can be a bother at times.  What I ended up with 
  1228. were a lot of files with .backup on them every I changed my startup-sequence!
  1229. This is the reason that this option is set to off as a Default.  You can 
  1230. access the toggling of this command by holding the right Amiga key down, and
  1231. hitting the b key.  I usually use the Menu to benefit from the status of the
  1232. checkmark.
  1233.  
  1234.                 "Use TextColor2 [RIGHT AMIGA/2]"
  1235.                 "Use TextColor3 [RIGHT AMIGA/3]"
  1236.                 "Normal Text [RIGHT AMIGA N]"
  1237.  
  1238. These last 3 items on the Options Menu are also new for Version 1.1 of Jed.
  1239. I grouped them together because they interact with each other.  You may only 
  1240. select ONE of the above three menu items at a time.  Jed's default is 
  1241. "Normal Text".  This is the mode you use most (99%) of the time.  But if you
  1242. are making a text file to be viewed with a text viewer (like "more"), or if
  1243. you want to print things to the CLI screen from a batch file (like in a 
  1244. startup sequence), you may choose one of the other TextColors above to 
  1245. create text with.  For instance, if you use the "TextColor2 [RIGHT AMIGA/2]",
  1246. you will begin to create text that will be SEEN in TextColor 2 when you use
  1247. the "Type" command from CLI.  This color will be seen as Black from an 
  1248. unaltered Workbench 1.3 environment.  Of course if you go to Preferences, and
  1249. change your default settings for Textcolor 2 from Black to Green for ,when 
  1250. your file is "typed" to a CLI screen, any text created in TextColor 2 will be
  1251. Green!  The option called "Use TextColor3 [RIGHT AMIGA/3]" works the same
  1252. except you will then create text in TextColor 3, which is ORANGE in an
  1253. unaltered Workbench 1.3 environment.
  1254. Upon choosing one of the 2 textcolors, you will see "^[[3Xm" inserted into 
  1255. your text. These are Screen Control codes that DO NOT TAKE UP SCREEN SPACE
  1256. WHEN PRINTING. So formatting your text will be a little strange until you get
  1257. used to using these options.  Try making a small file, then save it to
  1258. RAM:, then use "CLI Command  ALT/Q" from the Commands Menu, and type the
  1259. following: "type ram:yourfile" [RETURN].  The "X" in "^[[3Xm" above stands 
  1260. for the Text Color.  You will see "^[[32m" for TextColor 2, and "^[[33m" for
  1261. TextColor 3.  When you reselect the "NormalText [RIGHT AMIGA/I]" Option, you
  1262. will see "^[[m" inserted into your text. By knowing this you can tell which 
  1263. TextColor you are in.  The Options Menu also KEEPS TRACK of which TextColor 
  1264. you are using by putting a Checkmark next to the CURRENT TEXTCOLOR ONLY.
  1265. You can check this by simply pulling down the Options menu, check which color
  1266. has a Checkmark by it, and then pulling the pointer down into the text and 
  1267. releasing the mouse button. As of Version 1.1 of Jed, this will no longer 
  1268. "Set the mark."
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.                             CHAPTER 6
  1306.  
  1307.                     The Get Around Menu
  1308.  
  1309. This menu is strictly for getting around in your text files.
  1310.  
  1311.                    "Top of File  F3"
  1312.  
  1313. This first item on the Get Around menu will take you to the very
  1314. beginning of the text file, and place your cursor on the first character.
  1315. It can be also invoked with the F3 key, which is much easier, especially
  1316. if you use the keyboard overlay.  This is handy if you want to check for
  1317. include files, variable declarations, and the like.  For non-programmers,
  1318. you can check the name of person to whom you are writing the letter to,
  1319. so as to spell it correctly.
  1320.  
  1321.                     "End of File  F4"
  1322.  
  1323. This is the logical 2nd  choice after using the Top of file above.  This
  1324. will take you to the end of the text file, or probably where you were at
  1325. when you decided to check the top of the file.  It can be invoked from
  1326. the menu, or from the F4 function key.
  1327.  
  1328.                     "Goto Line  F5"
  1329.  
  1330. This 3rd choice on the Get Around Menu is for going to a specific line in
  1331. the text (or source code).  This is especially useful for programmers, as
  1332. it corrects for the Manx and Lattice Compiler's, and the Metacomco Macro
  1333. Assembler's error reporting.  All three seem to catch errors 1 line too
  1334. late and therefore report the wrong line by 1 line (IE - Line 98 really
  1335. has an error in coding on line 97).  I just subtracted one from the line
  1336. routine. If you use the Compiler's or Assembler's error complaint number,
  1337. you will end up on the correct line.  You can access this command from
  1338. the menu, of by the F5 function key.
  1339.  
  1340.                     "Page Down  F6"
  1341.  
  1342. This will move the cursor down  by 22 lines of text, or just a little
  1343. less than one screen full of text.  This is much easier than cursoring up
  1344. 22 times but is not a true full 66 line page of text.  You can access
  1345. Page down by 4 ways!  First from the menu, 2nd, from the F6 key, 3rd,
  1346. from the Emacs standard of holding the CTRL key down and then pressing
  1347. the v key, or 4th, by clicking the Left Select mousebutton on or below
  1348. and to the right of the word FILE: in the Status Bar.
  1349.  
  1350.                     "Page Up  F7"
  1351.  
  1352. This Last command on the Get Around menu (and also the last on JED's
  1353. menus), will move the cursor up by 22 lines of text.  Again, as above,
  1354. this is not a full printed page of text, but a screen page.  It can be
  1355. accessed  by the menu, or by the F7 function key, or by the Emacs way of
  1356. holding down the ALT key, and pressing the v key, or by clicking the Left
  1357. Select button on or below and left of the word "BUFFER:" in the Status
  1358. Bar.
  1359.         
  1360.  
  1361.  
  1362.  
  1363.                     MENU CONCLUSION
  1364.  
  1365. This concludes the menus currently available on The Jam Editor V1.1.  There
  1366. are several tricks and shortcuts, that have been left out of the
  1367. discriptions, all for the sake of brevity. And there are many options
  1368. that have been left off the PullDown Menus, also for the sake of brevity,
  1369. and in the case of pulldowns, for the sake of clarity and an easy
  1370. learning curve.  Please experiment with the editor on a copy of text at
  1371. first, or with the Backup Option on (from the Options menu).  You will
  1372. find, as time goes on, that JED is very simple to use and quite effective.
  1373. At least that was my goal.  I am always open to new suggestions, and ideas
  1374. that you might have for improving The Jam Editor, and appreciate your comments.
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.                          CHAPTER 7
  1410.  
  1411.                       The Function Keys
  1412.  
  1413. Most  of the Function keys listed below can be found in various sections
  1414. of the PullDown menu descriptions.  Those that can are listed with a
  1415. reference page number to where a description of their use can be found. 
  1416. Those that can't will have a page number listed.  This is  where thier
  1417. brief Emacs Command key description can be found.  These commands are
  1418. generally self explanatory when you use them.  The exception is the
  1419. Repeat command, (Shift/F9).  It asks for a repeat amount, then repeats
  1420. the next character typed that many times.  All of the function keys are
  1421. the first thing shown when you enter the Help file in JED (with the HELP
  1422. key), so you will rarely have use for this section.
  1423.  
  1424. Key      Command       Reference  Keys        Command            Reference
  1425. ---      -------       ---------  ----        -------          ---------
  1426.  
  1427. F1      = Save           Page 11   Shift/F1  = Search Forward      Page 16
  1428. F2      = Load           Page 11   Shift/F2  = Search Backward     Page 27
  1429. F3      = Top of file    Page 24   Shift/F3  = Query/Replace       Page 16
  1430. F4      = End of file    Page 24   Shift/F4  = One Window          Page 20
  1431. F5      = Goto Line      Page 24   Shift/F5  = Show Line & Column  Page 27
  1432. F6      = Page Down      Page 24   Shift/F6  = List Buffers        Page 28
  1433. F7      = Page Up        Page 24   Shift/F7  = Other Buffer        Page 11
  1434. F8      = Cut Block      Page 14   Shift/F8  = Kill Buffer         Page 11
  1435. F9 + F9 = Paste Block    Page 14   Shift/F9  = Repeat              Page 27
  1436. F10     = Quit & Save    Page 12   Shift/F10 = Quit                Page 13
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.                         CHAPTER 8
  1462.  
  1463.                     The KeyBoard Commands
  1464.  
  1465. The following commands are generally Emacs compatible. Some are duplicate
  1466. commands for those of you that are used to using Emacs, or MicroEmacs.
  1467. They are divided into sections by keys needed to cause them to be invoked.
  1468.   
  1469. THE CTRL KEY + OTHER KEY COMMANDS
  1470. ---------------------------------
  1471.  
  1472.    COMMAND     = DESCRIPTION
  1473.    -------       -----------
  1474.   
  1475.   <CTRL + @>   = Set Mark at current position.
  1476.   <CTRL + A>   = Move cursor to beginning of line.
  1477.   <CTRL + B>   = Move cursor BACK one character.
  1478.   <CTRL + C>   = Enter a new CLI window (in JED).
  1479.   <CTRL + D>   = DELETE current character.
  1480.   <CTRL + E>   = Move cursor to END of line.
  1481.   <CTRL + F>   = Move cursor FORWARD one character.
  1482.   <CTRL + G>   = Abort any command.
  1483.   <CTRL + H>   = (Backspace) delete previous character.
  1484.   <CTRL + I>   = Insert a TAB char or TAB number of spaces
  1485.   <CTRL + K>   = KILL (delete) to end of line.
  1486.   <CTRL + L>   = Redisplay screen.(CLEAN UP if garbage)
  1487.   <CTRL + M>   = End current line and start a new one.
  1488.   <CTRL + N>   = Move cursor to NEXT line.
  1489.   <CTRL + O>   = OPEN a new line.
  1490.   <CTRL + P>   = Move to PREVIOUS line.
  1491.   <CTRL + Q>   = QUOTE (insert the next character typed).
  1492.   <CTRL + R>   = REVERSE Search.
  1493.   <CTRL + S>   = Forward SEARCH.
  1494.   <CTRL + T>   = TRANSPOSE character under cursor and Previous character.
  1495.   <CTRL + U>   = Enter repeat count for next command.
  1496.   <CTRL + V>   = VIEW the next screen (scroll up one screen).
  1497.   <CTRL + W>   = Kill region (all text between cursor and last mark set).
  1498.   <CTRL + Y>   = YANK (undelete) last text killed (from Killbuffer).
  1499.   <CTRL + Z>   = Save file in current buffer and exit.
  1500.  
  1501.  
  1502.    THE CTRL KEY + X KEY + OTHER KEY COMMANDS
  1503.    -----------------------------------------
  1504.   <CTRL + X> + !   = Deleted due to Guru problems - was Paragraph fill.
  1505.   <CTRL + X> + =   = Show the current cursor position in the file.
  1506.   <CTRL + X> + (   = Begin keyboard Macro.
  1507.   <CTRL + X> + )   = End keyboard Macro.
  1508.   <CTRL + X> + 1   = Display only current window.
  1509.   <CTRL + X> + 2   = Split the current window.
  1510.   <CTRL + X> + B   = Prompt for new BUFFER.
  1511.   <CTRL + X> + E   = EXECUTE keyboard Macro.
  1512.   <CTRL + X> + I   = Toggle the Auto Indentation Mode.
  1513.   <CTRL + X> + K   = KILL a Buffer.
  1514.   <CTRL + X> + N   = Move to NEXT Onscreen window.
  1515.   <CTRL + X> + P   = Move to PREVIOUS Onscreen window.
  1516.   <CTRL + X> + T   = Toggle word wrap.
  1517.   <CTRL + X> + Z   = Enlarge current window by repete count lines.
  1518.  
  1519.                 
  1520.   THE CTRL KEY + X KEY + CTRL KEY + OTHER KEY COMMANDS
  1521.   ----------------------------------------------------
  1522.   <CTRL+X> + <CTRL+B>  = Show active BUFFERS.
  1523.   <CTRL+X> + <CTRL+C>  = EXIT without saving buffers.
  1524.   <CTRL+X> + <CTRL+F>  = FIX a new BUFFER NAME.
  1525.   <CTRL+X> + <CTRL+L>  = Change a region to LOWER case.
  1526.   <CTRL+X> + <CTRL+O>  = Take OUT blank lines.
  1527.   <CTRL+X> + <CTRL+N>  = Scroll current window up by repete count lines.
  1528.   <CTRL+X> + <CTRL+P>  = Scroll Window Up (Repete Count) Lines.          
  1529.   <CTRL+X> + <CTRL+R>  = READ File into Current Buffer.
  1530.   <CTRL+X> + <CTRL+S>  = SAVE (write) Current Buffer into it's file.
  1531.   <CTRL+X> + <CTRL+U>  = Change a region to UPPER case.
  1532.   <CTRL+X> + <CTRL+V>  = VISIT a file and Display in Current Window.
  1533.   <CTRL+X> + <CTRL+W>  = WRITE buffer to file.
  1534.   <CTRL+X> + <CTRL+X>  = Swap  [Block Mark]  &  [Cursor Position].
  1535.   <CTRL+X> + <CTRL+Z>  = Reduce current window by (Repete Count) lines.  
  1536.  
  1537.  
  1538.   THE ALT KEY + OTHER KEY COMMANDS
  1539.   --------------------------------
  1540.   <ALT> + !        = Move Current Line (Repeat Count) Lines from Top.
  1541.   <ALT> + %        = Query Replace.
  1542.   <ALT> + .        = Set mark at cursor position
  1543.   <ALT> + >        = Move cursor to end of buffer.
  1544.   <ALT> + <        = Move cursor to beginning of buffer.
  1545.   <ALT> + B        = Move cursor BACK one word.
  1546.   <ALT> + C        = CAPITALIZE word.
  1547.   <ALT> + D        = DELETE next word.
  1548.   <ALT> + E        = EXECUTE a Keyboard Macro
  1549.   <ALT> + <DEL>    = DELETE previous word.
  1550.   <ALT> + F        = Move cursor FORWARD one word.
  1551.   <ALT> + L        = LOWERCASE (lowercase) next word.
  1552.   (ALT> + M        = MOVE to a specified Line Number
  1553.   <ALT> + Q        = QUEUE up a one CLI Command and return to JED.       
  1554.   <ALT> + U        = Change next word to UPPERCASE.
  1555.   <ALT> + V        = VIEW the previous screen (scroll down one screen).
  1556.   <ALT> + W        = WASTE a block of text from the file (to the KillBuffer).
  1557.   <ALT> + Y        = YANK a Block from KillBuffer to the Cursor Position.
  1558.   <ALT> + <CTRL+H> = Delete backward word.
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.   JED Right Amiga Shortcut KeyList
  1566.   --------------------------------   
  1567.   RIGHT AMIGA + h = HARDCOPY of the Current Buffer
  1568.   RIGHT AMIGA + p = PRINT the currently marked Block.
  1569.   RIGHT AMIGA + w = WHO created The Jam Editor?
  1570.   RIGHT AMIGA + c = COPY the mark block of text to the Killbuffer.
  1571.   RIGHT AMIGA + s = SAVE the current Killbuffer to a file.
  1572.   RIGHT AMIGA + m = MACRO definition beginning. 
  1573.   RIGHT AMIGA + e = END macro definition.
  1574.   RIGHT AMIGA + i = ICONS will be created for all text saved.
  1575.   RIGHT AMIGA + l = LEFT Margin settings.
  1576.   RIGHT AMIGA + r = RIGHT Margin settings.
  1577.   RIGHT AMIGA + b = BACKUP original copys of files saved.
  1578.   RIGHT AMIGA + 2 = 2ND Textcolor is now being used to create text.
  1579.   RIGHT AMIGA + 3 = 3RD Textcolor is now being used to create text.
  1580.   RIGHT AMIGA + n = NORMAL Text is now being created.
  1581.  
  1582.                  
  1583.                 
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.  
  1594.  
  1595.  
  1596.  
  1597.  
  1598.  
  1599.  
  1600.  
  1601.  
  1602.  
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617. REGISTERING YOUR COPY OF THE JAM EDITOR
  1618. ---------------------------------------
  1619.  
  1620. If you feel JED is useful, and continue to use it after whatever you feel
  1621. is a REASONABLE tryout period, PLEASE register it using the form below. 
  1622. I will then keep you informed as to updates (if you prefer - see choice
  1623. on form), which will be major updates only, as such will cost $5.00.
  1624.  
  1625. Also feel free to fill in the sections on "Comments", "Suggested
  1626. Additions", and most importantly, "Bugs"!!  I used JED to develop itself,
  1627. and found that my productivity went up as I progressed.  Also the number
  1628. of 'Little red windows at the top of my screen', or 'dancing with Mr. G,
  1629. or properly, Guru Meditation incidents, went down to (so far) NIL: .  But
  1630. this does not mean by any means that I do not make mistakes, so......
  1631. Point 'em out!  I will do my best to remove them as fast as time will
  1632. allow.  This is my first shareware attempt.  If you like my efforts, and
  1633. the Jam Editor, Please register for $7.00, (so that I can continue to
  1634. convince my Wife that this has all been worth it!).  If you registered 
  1635. already, and are just updating, send only $5.00.
  1636. The Address is:
  1637.  
  1638.         Dan Burris
  1639.         P.O. Box 290041
  1640.         Hartland, Michigan
  1641.         48029-0041
  1642.  
  1643. So here's the Form:
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.                  Another Jam Editor V1.1 Registration!
  1671.           
  1672.  
  1673.   First Name:___________________  Last Name:___________________  M.I.___
  1674.  
  1675.   Street:_______________________________________________________________ 
  1676.   
  1677.   City:______________________  State:_______________ Zip Code___________
  1678.  
  1679.   Do you wish to be notified of Updates to JED?       YES___   NO___
  1680.   
  1681.   Is this an Update? YES___  NO___   If so, from what version? _________
  1682.   
  1683. Comments:_______________________________________________________________
  1684. ________________________________________________________________________
  1685. ________________________________________________________________________
  1686. ________________________________________________________________________
  1687. ________________________________________________________________________
  1688.  
  1689. Suggested Additions:____________________________________________________
  1690. ________________________________________________________________________
  1691. ________________________________________________________________________
  1692. ________________________________________________________________________
  1693. ________________________________________________________________________
  1694.  
  1695. Suspected Bugs:_________________________________________________________
  1696. ________________________________________________________________________
  1697. ________________________________________________________________________
  1698. ________________________________________________________________________
  1699. ________________________________________________________________________
  1700. ________________________________________________________________________
  1701.